Patcheur PSX v1.0b
Terminus Traduction - 2004

Sommaire

1. Présentation
2. Historique
3. Contenu de l'archive
4. Utilisation
5. Ce qu'il reste à faire
6. Contacts
7. Remarques légales

I. Présentation
Ce petit logiciel a pour but l'application de patchs sur des jeux Playstation. Celui-ci gère la création éventuelle de l'image du CD sur le disque dur et l'application du patch dans un format particulier.
Attention cette version est néanmoins limitée à Windows. Ceci est temporaire, le noyau du programme étant programmé en Java, les fonctions annexes placées dans la bibliothèque seront ensuite entièrement codées en Java et des modules spécifiques seront créés pour les différents systèmes d'exploitation.

II. Historique
26-07-2004 - v1.0b : Première version limitée en options et plateforme du patcheur PSX (pour Chrono Cross dans un premier temps) réalisé entièrement par Nemesis.

III. Contenu de l'archive
L'absence de n'importe lequel des fichiers cités ci-après peut empêcher l'exécution du programme. L'archive que vous avez décompressé devrait contenir :

- Patcheur.jar : exécutable Java 1.5 ou supérieur à lancer pour patcher.
- Patcheur.dll : bibliothèque de routines spécifiques à Windows pour la création de l'image et certaines opérations d'application.
- Lisez-moi.html : document que vous lisez actuellement.

IV. Utilisation
Avant de pouvoir utiliser le patcheur vous devez tout d'abord installer la Java Runtime Environment (JRE) en version 1.5 ou supérieure disponible sur le site de Sun à l'adresse suivante : http://java.sun.com/j2se/1.5.0/download.jsp
Le téléchargement est assez lourd mais peut servir à quantité d'autres applications et à l'affichage et éxécution des derniers Java Script sur Internet. Une fois cette étape franchie, il ne vous reste plus qu'à double cliquer sur le fichier Patcheur.jar pour exécuter le programme comme un EXE standard.
Au lancement, le programme vous demande de lui indiquer le patch que vous souhaitez appliquer pour tester son intégrité et afficher les informations qu'il contient. Vous devez choisir à ce moment-là le fichier ptt (Patch Terminus Traduction) que vous aurez téléchargé à part correspondant au jeu désiré. Celui-ci peut se trouver n'importe où sans que ça influence l'application.
L'utilitaire comporte 5 onglets qui sont détaillés plus bas, et une barre d'avancement de l'application placée à droite. L'interface n'est ni très évoluée ni graphiquement éblouissante mais permet une application simple du patch.
L'onglet Informations fournit les informations sur le jeu et le patch présentes dans le fichier patch (extension ptt). Vous y retrouverez les rubriques habituelles des patchs au format html. Vous pouvez le consulter à tout moment en lançant le programme et éventuellement le lire pendant l'application plus ou moins longue du patch.
L'onglet Options vous permet de régler les paramètres d'application du patch. Voici en détail leur utilité :

- Extraire directement depuis le CD : cette option permet la création d'une image disque à partir du CD d'origine pour vous faciliter la vie. Cette opération est longue et la copie n'est pas encore optimisée. Vous avez alors le choix du lecteur disponible à utiliser sur la droite.
- Utiliser une image de CD existante : utiliser directement une image CD créée auparavant avec un autre logiciel. Le programme s'aligne automatiquement sur les secteurs de l'image pour éviter d'éventuelles incompatibilités.
- Conserver une copie : permet la sauvegarde de l'image créée et/ou utilisée en cas de problème d'application. Cette copie est plus ou moins longue, mais les fichiers sont généralement conséquents. Vérifiez donc toujours que vous disposez de suffisamment d'espace disque sur la partition utilisée.
- Fichier source/cible : choix du fichier d'image CD. Celui-ci peut être sélectionné via le bouton Parcourir ou le nom et le chemin peuvent être directement tapés si on a choisi sa création à partir du CD.

Les autres options n'étant pas ou pas totalement implémentées, elles ne sont pas fonctionnelles et non développées ici.
L'onglet Structure affiche sous forme arborescente le contenu du patch. La racine porte en théorie le nom du patch. A chaque branche correspond un ensemble d'opérations et à chaque feuille correspond une opération atomique. Les cases à cocher serviront dans une version future à appliquer partiellement le patch, en cas de bug par exemple, où permettre des mises à jour simples et rapides en ne sélectionnant que les élements qui ont changé.
L'onglet Log trace les erreurs et évolutions de l'application et de la création de l'image. C'est ici que vous serez renvoyés si l'application s'arrête et qu'un bug se produit. Si tout se passe bien, cette fenêtre devrait afficher le message de terminaison en fin de log suivant : "Fermeture et mise à jour de la table effectuées". Enfin l'onglet Aide doit afficher le fichier que vous consultez actuellement pour vous permettre une lecture rapide des instructions.
Dernier élément de l'interface, la barre d'avancement à droite vous indique à quelle étape de l'application vous en êtes. Il suffit de cliquer dessus pour démarrer l'exécution du patch une fois les options réglées. La fonctionnalité de pause n'est pas totalement implémentée et tout bug survenu pendant l'exécution oblige à un redémarrage de l'application. Une fois l'application terminée elle devrait vous afficher le message "Fini ! Bon jeu !".
Vous pourrez bien sûr fermer l'application et lancer votre jeu une fois l'application terminée. L'application peut être très longue selon la complexité et le nombre d'opérations effectuées (plusieurs milliers pour Chrono Cross par exemple). Ne désespérez donc pas si l'exécution prend bien plus de temps que pour un simple patch au format IPS. Il n'y a pas de souci à se faire tant que l'ordinateur travaille et que l'application ne pas gelée.

V. Ce qu'il reste à faire
Trop de choses sont à faire hélas. Le programme a été commencé en Mai 2004, et peu de temps lui a malheureusement été consacré depuis. Voici une liste non exaustive des fonctionalités en cours d'introduction où qui devraient l'être :

- Intégration de certaines routines écrites pour l'instant en C/C++.
- Activation des nombreuses options et fonctions non finalisées.
- Réinitialisation complète en cas d'erreur pour pouvoir relancer.
- Support HTML amélioré (en particulier pour les images).
- Activation des liens hypertextes.
- Finalisation de la Pause/Reprise.
- Avancement plus clair en pourcentage (par exemple pour la copie de CD).
- Et beaucoup beaucoup d'autres choses...

VI. Contacts
Pour toute question sur le patcheur ou pour son utilisation à d'autres fins, contactez-moi (tt_nemesis@yahoo.fr) ou envoyez un mail à Terminus Traduction (terminus@romhack.net). N'étant pas disponible au mois d'août 2004, vous pouvez également poser vos questions sur le forum qui lui est consacré avec Chrono Cross (http://terminus.romhack.net/forum). Ce forum n'est pas permanent est reste exclusivement réservé aux questions liées au projet Chrono Cross en phase de bêta-test. Les modifications ne pourront bien sûr être apportées qu'à partir de septembre, période de retour du programmeur ;)
Tout programmeur intéressé par le code source, même si peu avancé, peut me le demander par mail ou utiliser directement ce qu'il put exploiter. Toutes les sources seront bientôt disponibles sous licence GNU, le temps très limité dont j'ai disposé ces derniers temps me contraignant pour l'instant. D'ici là vous êtes libre d'utiliser toute portion de code comme bon vous semble, évitez simplement les abus. Dans ce dernier cas, envoyez un mail, vous pourrez disposer d'un code commenté.
Merci d'avoir lu jusqu'au bout et bon jeu.
Nemesis

VII. Remarques légales
Ce logiciel est entièrement gratuit et peut être distribué gratuitement tant que son archive n'est pas modifiée. Ni argent, biens ou services ne peuvent être demandés pour ce logiciel. Tous ceux qui utilisent ce programme le font à leurs propres risques. Aucune personne citée dans cette documentation ne pourra être responsable de quelconques dommages provenant de son usage aussi bien au niveau ordinateur que console Playstation ou Playstation 2.